home *** CD-ROM | disk | FTP | other *** search
/ Workbench Design / WB Collection.iso / datatypes / bmpdt / bmpdt.guide (.txt) next >
Amigaguide Document  |  1996-04-07  |  4KB  |  78 lines
  1. @database BMP.guide
  2. @author Gunther Nikl
  3. @$VER: BMP.guide 1.3 (11.8.95)
  4. @node Main "BMP picture datatype"
  5.            BMP Picture DataType for Workbench 3.0 or above
  6.                    Written by Gunther Nikl in 1995
  7.                            FreeWare
  8.                       I.   @{" Introduction " link Introduction}
  9.                       II.  @{" Installation " link Installation}
  10.                       III. @{" Bugs         " link Bugs}
  11.                       IV.  @{" Author       " link Author}
  12.                       V.   @{" History      " link History}
  13. @endnode
  14. @node Introduction
  15. This datatype has been created to supersede the bmp.datatype v39.4 from the
  16. 3.1 NDK. That datatype was limited to 16 and 256 color pictures, handled only
  17. Windows type BMPs (but didn't check for this) and had other quite serious bugs
  18. - one of them crashed my Amiga.
  19. Sometime ago I had to deal with pictures in BMP format and so I got some
  20. information about the format. To use these information I decided to create a
  21. datatype since I wanted to know if its possible to use gcc to program one :^)
  22. The datatype supports 1, 4 and 8 Bit BMPs. It handles OS/2 1.x, Windows 3.x
  23. and OS/2 2.x types of BMPs correctly. The bmp.datatype does currently (?) not
  24. support 24 bit and compressed BMPs.
  25. Please note:
  26.   1.) Some types of BMP pictures are called to be in a 'DIB' format, but these
  27.       are simple BMPs only with another extension.
  28.   2.) Compressed BMPs are usually bigger than the uncomprossed ones (AFAIK)
  29.       and have often a '.rle' file extension.
  30.   3.) Pictures from OS/2 Warp are in the OS/2 2.x format, thus can be handled
  31.       by this datatype (as long as the pictures are uncompressed of course) 
  32. @endnode
  33. @node Installation
  34. The "BMP" datatype distribution should consist of the following files:
  35.  Classes/DataTypes/bmp.datatype
  36.  Devs/DataTypes/Windows BMP
  37.  Devs/DataTypes/Windows BMP.info
  38.  BMPdt.guide
  39.  BMPdt.guide.info
  40.  Source code
  41. Copy the "bmp.datatype" into the "SYS:Classes/DataTypes" drawer. The "BMP" and
  42. "BMP.info" files should be placed in the "DEVS:DataTypes" drawer. In order to
  43. use the datatype doubleclick on the BMP.info file (or reboot the machine).
  44. @endnode
  45. @node Bugs
  46. Currently none known :^)
  47. @endnode
  48. @node Author
  49. The "BMP" datatype was written from scratch by Gunther Nikl using GNU-C 2.7.0 for
  50. the C-part and SNMA for the assembler part. All required information to create the
  51. datatype were obtained from the sample source code by David N. Junod found in the
  52. 3.1 NDK.
  53. The author can be reached at:
  54.   email: gnikl@informatik.uni-rostock.de
  55.          or
  56.   snail: Gunther Nikl
  57.          Ziegendorfer Chaussee 96
  58.          Parchim
  59.          19370
  60.          GERMANY
  61. Final note: Use at your own risk!
  62. @endnode
  63. @node History
  64. v40.4 [ previous version was released a little bit to fast ]
  65.       - forget to correct the normal address in the guide :(
  66.       - source code cleanup (reduced the executable size :-)
  67. v40.3 - fixed a serious bug with 8-bit images (did not use a
  68.         separate pixel buffer for WritePixelLine8(), but this
  69.         is *absolutely* required due to a size restriction...)
  70.       - switched from AllocVec() to exec pool-functions of V39+
  71.       - reduced stack usage
  72. v40.2 - library bases are now taken directly from the classbase
  73.         (no additional global library bases required anymore)
  74.       - fixed a (harmless) bug in the bmpheader decode function
  75.       - freed a buffer in the image decoder at a wrong place...
  76. v40.1 - initial release
  77. @endnode
  78.